Skip to content

feat: the look of Didactika, a home, the Moodle directory status, a footer with people and support, and a site served as deployed - #1

Merged
hector-ae21 merged 8 commits into
mainfrom
feat/versions-and-preview
Nov 11, 2026
Merged

hector-ae21 merged 8 commits into
mainfrom
feat/versions-and-preview

Conversation

@hector-ae21

Copy link
Copy Markdown
Member

Takes the design system of Didactika with Material icons: header with product and version selector, a language menu that filters and scrolls, search, page titles with provenance, a dashboard home with the mark of Didactika Docs, and a navigation that shows only the product and version of the reader. The footer is the one of the design system: co-founders, collaborators and funding come from GitHub (tools/project.ts). Routes (Path) guide each kind of reader through a product. The synchronisation brings images and icons, asks the Moodle directory whether each plugin is published and lets MDX pages use the components of the site. docker compose serves the built site and rebuilds it when the documentation changes. rup/didactika.theme.json is the palette for the diagrams of the technical documentation.

…ersion

compose.yaml serves the site with the development server and reads the products from clones on the machine, with preview.refs.json to
read branches that are not merged yet. The synchronisation writes only what changed and deletes what is stale, so the server reloads
without noise. Pages may use the alerts of GitHub and page: links that stay in the version and language of the reader. A front matter
that is not valid YAML is reported as an error of that page. The navigation has one group for each version, with the sections translated.
…ry and a site served as it is deployed

The site takes the design system of Didactika (its palette, IBM Plex Sans, Space Grotesk and IBM Plex Mono) with the Material Symbols icons: a
header with the product and the version selector, a search that works with the built site, a title for each page with its provenance, a footer
with the previous and next pages, and a home that is a dashboard of the documented products. The navigation shows only the product and the
version the reader is in.

The synchronisation brings the images and the icon of each product, tells whether a plugin is in the Moodle directory from the API of Moodle,
lists what is documented next and lets the pages of MDX use the components of the site without importing them. docker compose now builds the
site and serves it as Pages will, building it again when the documentation changes.
… the Didactika theme for technical docs

The footer is the one of the design system (co-founders, collaborators and funding from GitHub), the language menu filters and scrolls so it can grow, the previous/next pager is gone, the home mark is the one of Didactika Docs, and a Path component gives each reader a guided route. rup/didactika.theme.json holds the colours for the diagrams of the technical documentation.
@socket-security

socket-security Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Added@​iconify-json/​material-symbols@​1.2.981001008096100
Added@​fontsource/​ibm-plex-mono@​5.3.0100100858390
Added@​fontsource/​space-grotesk@​5.3.0100100838390
Added@​fontsource/​ibm-plex-sans@​5.3.0100100858690

View full report

…collapsed sections and the notice to deploy

The synchronisation reads the technical documentation of a product (README as the index of a folder, diagrams and tables next to a page, relative links, the first heading as the title), the sidebar orders it as the method does, the home invites to support the project and credits rup-flow Pro, and the workflows give the build the token the footer needs.
…roducts on the home and a page of resources

The search sits after the product and the version as in the design system and the menu of a small screen opens with the product and its versions. The home shows the three products that changed last with a link to the whole catalog, leaves room for the libraries and no longer talks about languages; the foot links to the list of resources of didactika.org. The quality section of the technical documentation is gone.
@hector-ae21
hector-ae21 merged commit f337628 into main Nov 11, 2026
3 checks passed
@hector-ae21
hector-ae21 deleted the feat/versions-and-preview branch November 11, 2026 23:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant